Cream of the Crop 1/Cream of the Crop 1.iso/UTILITY/DOLST298.ARJ/DOLIST.DOC

Text File | 1990-12-27 | 26KB | 747 lines

Computer Tyme DOLIST * Copyright 1988-1990 by Marc Perkel
All Rights Reserved * Version 2.96 * Release Date: 10-25-90

Registration $59.95 required!
Add $3 Shipping and Handling.

These programs are part of the Computer Tyme Utilities Pack which includes
these utilities and more. If you like what you see here, you'll love the
whole package.

Commercial and Site Licenses Available.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

DoList is a dual purpose program. It acts as a DOS SHELL, allowing the easy
and convenient entry of DOS commands. In this mode, DoList emulates and
enhances many of the functions of COMMAND.COM. In the LIST mode, DoList
is capable of executing commands on a LIST of files.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

DoList in the SHELL mode:

DoList has the ability to act like a DOS SHELL. Whenever input redirection
is not specified, input comes from the standard input device. DoList
detects this and uses it's powerful line editor to provide input lines.

To use DoList in the shell mode type DOLIST. DoList will confirm
keyboard input with the message:

Shell Mode Enabled * Type "EXIT" to Return to DOS.

Shell mode allows to type you command lines with the editing power of a
word processor. It stores the commands you execute so that you can recall
them and re-execute them. And it remembers the subdirectories that you've
moved to, allowing you to easily move back to where you've been.

During shell mode, all normal word processor editing keys, (Home, End, Arrows),
work to edit the command line. The UP arrow recalls the previous commands
you've executed and the DOWN arrow reverses this process. The Escape key
aborts command line entry. The WORDSTAR command set is also supported.

DoList inputs commands from it's powerful line editor and executes the line
as a subtask. Due to this, you loose about 27k of ram.

Typing \ changes you to the root directory. Typing - changes you to the
previous directory. Typing a directory name allow you to change to that
directory without typing CD.

If PD (Pick Directory) is present, if you type CD to change directories in
DoList, and it fails to change, DoList will load PD as a subtask. This allows
DoList to change directories on a partial name match.

DoList remembers the subdirectories you've been to. By pressing the TAB key,
DoList will rotate you through the last several directories you've been to.
This allows you to switch between directories quickly and easily. The
SHIFT TAB key rotates through the directories in the opposite direction
from the tab key. The ALT TAB is just like TAB except it removes the
directory from the rotate list.

DoList will execute BASIC programs without having to type BASIC. DoList
recognizes the .BAS extention and loads BASIC for you.

When using DOLIST in a .BAT file, if you want execution to continue after
loading DOLIST, type DOLIST <cmd>. Where <cmd> is any dos command you want
to execute which could be another .BAT file.

DoList requires DOHELP.EXE to be on an executable path. DoHelp is loaded
by DoList and reads the DOLIST.CGF file. This file is a text file that contains
the Programmable Function Key definitions and other defaults. DoHelp also
is loaded to provide enhanced access to several dos function. This includes
the commands SET, PATH, PROMPT, COMSPEC, MD, RD. DoList will not run in the
SHELL mode without DoHelp.

If you try to remove a directory that is not empty, DoList will ask you
if you want to remove it anyway. If you say yes, DoList will load PIPEDIR
as a subtask and will remove the directory. PipeDir must be present to use
this feature.

DoList can execute more than one command on the same command line.
This is done by sepatating the commands with a double bar. ||

Examples:
  Free C:||Free D:||Free E:
  Format A:||Sys A:||Copy Command.com A:

DoList can display MS-DOS exit return codes. This feature is controlled
by typing "@RC ON/OFF". If a subprogram terminates with anything other
than a normal return code, DoList displays it.

Although not required, DoList will use PIPEDIR, WHEREIS, SORT, PD, and
BASIC where it can. If these programs are accesable, DoList will find them
and use them. DoList searches for BASIC under the names BASIC, BASICA and
GWBASIC and uses the first one it finds.

Dolist contains the commands @RC ON/OFF to display the return codes from
programs that it executes. This is for the advanced user to debug use of
return codes in batch files.


Programmable function keys are set up by editing the DOLIST.CFG file.

Sample DoList Configuration File:

;DoList Configuration File

;This file is read on DoList startup. DoList executes the command
;DOHELP CONFIG. DoHelp then reads this file and sets DoList up.

;ReturnCodes show program return codes that are non zero
ReturnCodes

;Trace is for DoList Debugging. Shows generated command lines.
;Trace

;Use AKEY if you want to add an ENTER at the end, BKEY if you don't.
;Function Keys F1-F10, AF1-AF10, CF1-CF10, SF1-SF10
;%C changes into the name of this configuration file.
;Note: Using || allows more than 1 command to be executed.

AKey AF1   EDIT %C||DOHELP CONFIG  ;Edit DoList Configuration
AKey CF1   DOHELP SHOWKEYS|MORE    ;Display Key Help
AKey SF1   DOHELP SHOWALIAS|MORE   ;Display Alias List
AKey AF2   Del *.BAK               ;Delete .BAK Files
BKey F4    *.*                     ;Type *.*
BKey AF4   A:*.*                   ;Type A:*.*
AKey F5    DM3.EXE                 ;Run DM3
BKey AF5   DM3.EXE                 ;Run DM3
AKey SF5   DM.COM                  ;Run DM
BKey CF5   DM.COM                  ;Run DM
AKey F7    PD /C                   ;Pick Directory
BKey F9    D                       ;Directory 4 Column
BKey AF9   D/N                     ;Directory 5 Column
BKey SF9   D/F                     ;Directory 2 Column
BKey CF9   D/O                     ;Directory Standard Output
AKey F10   D                       ;Directory 4 Column
AKey AF10  D/N                     ;Directory 5 Column
AKey SF10  D/F                     ;Directory 2 Column
AKey CF10  D/R                     ;Directory Files that Run

AKey ALT-C Cls                     ;Clear Screen
AKey ALT-D DoList                  ;Load DoList
BKey ALT-E Edit                    ;Run QEdit
AKey ALT-F Free                    ;Free Space
AKey ALT-M Map                     ;Memory Map
BKey ALT-N NW1                     ;New Word Non Doc Mode
BKey ALT-P Patch                   ;Patch File
AKey ALT-S SM D                    ;Load Smart DataBase
AKey ALT-T Turbo                   ;Turbo Pascal
BKey ALT-W Whereis                 ;Run Whereis
BKey ALT-X Pkxarc -r               ;UnArc File

AKey ALT-5 @Trace Off              ;Debug DoList
AKey ALT-6 @Trace On               ;Debug DoList
AKey ALT-7 Park                    ;Park Hard Disk

;Aliases are used to translate commands. The first word is translated
;into the rest of the line.

Alias DEBUG \DRDOS\SID86

;end

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

Did you ever want to execute a program on a LIST of files? That's what DoList
does. DoList will execute a command line and substitute text from the
standard input device in the command line.

Suppose you had a file name BAK.LST that contained the following list of files:

NOTES.BAK
JOBS.BAK
AUTOEXEC.BAK

If you want to delete all the files in the list you type:

DOLIST DEL @L < BAK.LST or
TYPE BAK.LST|DOLIST DEL @L

DoList will then execute the following commands:

DEL NOTES.BAK
DEL JOBS.BAK
DEL AUTOEXEC.BAK

DoList reads each line from the standard input device and executes
the command for each line read. The @L causes DoList to insert the
next input line into the command.

Suppose we wanted to copy all the *.BAT files to drive A:.
We would type:

PIPEDIR \*.BAT /S|DOLIST COPY @L A:

Or if we wanted to create an ARC file of all the *.BAT files we would type.

PIPEDIR \*.BAT /S|DOLIST ARC A BAT.ARC @L

In addition to the @L command which substitutes the whole line, DOLIST
can look at the lines as fields that can be substituted individually.
The individual fields are substituted by @1 thru @9.
In the text line:

456,NOTES.TXT "Marc Perkel"

@1 = 456
@2 = NOTES.TXT
@3 = Marc Perkel

The rule is that commas and spaces are delimiters unless you start
with a quote. If you start with a quote, the next quote is the delimiter.

If you don't want DoList to actually execute the commands, the @T
command will cause DoList to output the text that it would have
executed. This text can be redirected to a file for later execution.

The @Q command makes DoList ask before executing each command line. This
allows you to skip the command or abort DoList.

Example:

PIPEDIR *.BAT >BAT.LST   ; creates BAT.LST with list of all *.BAT files.
DOLIST COPY @IBAT.LST @L@T A: @OTEST.BAT   ;reads each line of BAT.LST
and creates the command COPY <line> A: and writes these commands to
a file named TEST.BAT.

Using braces '{}' suspends interpretation of @ commands allowing the
@ to be part of the command. The outermost pair of braces are removed
from the command. This is useful when using DoList recursively. That
means using DoList to run DoList.

When a command line is presented to DOS, the redirection and piping
commands, < > | are interpreted and removed. In order to pass these
commands to a program that DoList can run, we must use other codes
that dos won't remove. The @[ is translated into <, the @] is translated
into >, the @]] is translated into >> and the @! is translated into |.


Using DoList Recursively:

Lets say we have a file named X.LST that contains the lines:
1
2
3

And a file named Y.LST that contains the lines:
A
B
C

The following command produces the following results:

DOLIST DOLIST @L{@L@T}@[x.lst <y.lst

A1
A2
A3
B1
B2
B3
C1
C2
C3

In this example, the outer DoList causes the inner DoList to be
executed three times. It executes the lines:

DOLIST A@l@t<x.lst
DOLIST B@l@t<x.lst
DOLIST C@l@t<x.lst

Notice that the outer DoList caused the first @L to be translated
into A,B,C from Y.LST and that @[x.lst was translated into <x.lst.
Also note that the braces {} were removed but the interpretation
of what was inside the braces is preserved for the inner DoList.

This type of processing opens up some interesting possibilities.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

DoList stays resident while executing so you lose about 27k of ram until
it finishes. If output is redirected to a file, then all child processes
are also redirected.

If you are not sure what a DoList command will do, use the @T option to
produce text instead of executing. If the commands are right, then use
it without the @T.


Summary of DoList Commands:

@L            ;substitute next input line
@1 .. @9      ;substitute field 1 thru 9
@T            ;output commands as text instead of executing them
@Q            ;query mode, displays command and asks for conformation
@[            ;substitutes < in command line
@]            ;substitutes > in command line
@]]           ;substitutes >> in command line
@!            ;substitutes | in command line
{}            ;commands in {braces} are not interpreted but passed as text

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

About PIPEDIR, WHEREIS, FORK, FIND, MORE, SORT, and PD:

Output from PIPEDIR is suitable for piping filenames into other
applications. PIPEDIR is also handy for finding and cataloging
files on a hard disk. Using /F will give you a detailed display.

Usage: PIPEDIR <Path\Mask> /S/H/T/P/A/N/F/D/R/Q

  /S includes all subdirectories below Path.
  /H include hidden and system files.
  /T gives only directory names.
  /P same as /T but adds a \ to the end.
  /A files that have been modified since last backup.
  /N names only, no path.
  /F full display, size, date, time, attributes.
  /D deletes files.
  /R remove directory, all files, and all subdirectories.
  /Q ask before delete.

Examples:

PIPEDIR \*.BAK /S      ;Prints all *.BAK files on disk.
PIPEDIR \*.BAK /S/D    ;Deletes all *.BAK files on disk.
PIPEDIR \ /T           ;Prints all subdirectory names.
PIPEDIR \*.* /S/A      ;Prints files changed since last backup.
PIPEDIR \ /S >ALL.TXT  ;Prints all files on disk to ALL.TXT.
PIPEDIR C:\JUNK /R     ;Removes directory JUNK and all files it contains.
PIPEDIR \ /S/F         ;Full detailed display of all files on drive.

PipeDir may be aborted by pressing Ctrl-C.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

WHEREIS is just like PIPEDIR except the root directory and /S options
are always selected.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

SORT.EXE is just like MS-DOS sort except that it is only limited by
memory size instead of 64k, and it is 100 times faster. Sort also has
a /I option to ignore case and will accept optional file names on the
command line for input and output.

Usage SORT <file> <file> /R/U/+N
Optional filenames for input and output files.

  /R    Reverse Sort.
  /+N   Start sorting with column N.
  /I    Ignore Case.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

MORE.EXE is just like MS-DOS more except a lot slicker. It erases its prompts
and gives you a pause at the end of the text stream. Pressing the space bar
advances a page at a time and pressing the return key advances a line at a time.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

FIND.EXE is just like MS-DOS find with the following additions:

Usage: FIND "String" <File File File> /V/C/N/L/P/I

  /V Displays all lines that do not contain String.
  /C Counts lines that contain String.
  /N Adds line numbers to output.
  /L List only names of files that contain String.
  /P Pauses display every 24 lines.
  /I Ignore Case.

<file> may include wildcards.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

FORK.EXE allows you to redirect piped files to the screen or another file
without interfering with the piping process.

DIR|FORK >X will do the same thing as DIR >X except you will be able
to SEE the text.

DIR|FORK Y >X will do the same thing as DIR >X except that output is
also directed to file Y.

DIR|FORK|SORT will show the directory first unsorted and then sorted.

If the first character after FORK is a / then the text after the / is
interpreted as a secondary command line to be executed with the text
comming into the pipe fed into the secondary command.

DIR|FORK /MORE|SORT|MORE will show the directory unsorted with a pause
every 24 lines, then sorted with a pause every 24 lines.

Since MS-DOS filters out redirection and piping commands, FORK interprets
the secondary command line. @] is translated into >, @]] is translated
into >>, and @! is translated into |.

DIR|FORK /FIND " COM "@] COM.LST|FIND "BAT" >BAT.LST
This command will make a list of all the *.COM files in COM.LST, and
all the *.BAT files in BAT.LST.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

PD allows you to change directories with as few keystrokes as possible.
If you type PD by itself it brings up a list of all directories off the
current directory.

Example:

Press ? for Help.

Current Directory: C:\TURBO4

 \ <Root>     D T1
 - <Prev>     E T2
 A BONUS      F TDEBUG
 B OM         G TMP
 C SRC        H TP4

Pick Directory:

By typing the letter in lower case it changes to that directory and brings
up the directories in the new directories. Upper case selects the directory
and exits. The - moves one level toward the root, \ goes to the root. Typing
CTRL and a letter selects new disk drive.

Lower case letter selects directory.
Upper case selects directory and exits.
Ctrl letter to change drives.

- Previous Directory
\ Root Directory
<CR> exit

PICK DIRECTORY also has the ability to select a path by typing
only a partial path name. To use this feature you must first
create a PD.PIC file which contains a list of all the directories
on all your hard drives. You must have Computer Tyme PIPEDIR and
SORT programs on you hard disk.

To create PD.PIC type PD /S <drives>. The <drives> is only
necessary if you have more that 1 hard disk or hard disk
partition. If you have hard drives C, D, E, and F, then you
would type PD /S DEF. Drive C is assumed.

After PD.PIC is created, all you have to do is type PD <dir>
where <dir> is all or part of a path. Suppose you are in the root
directory and you want to change to the \SMART\DATA directory.
Normally you would type CD \SMART\DATA. With PD you would type PD DATA.

PD does a search through PD.PIC for the first directory listing
that matches what you type in. All you have to do is type enough
characters to uniquely identify to directory you want.

Any time you add or delete a directory, you should run
PD /S <drives> to keep PD.PIC current.

After creating the PD.PIC file, you can use a third method
of changing directories. By typing PD /C, Pick Directory
displays a directory tree and allows you to use your cursor
controls to move to the directory and drive you want.

               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*


Fun with DOLIST:

Some of these examples assume that the reader knows the commands
ARC and PKARC. These programs are used mostly by people who use modems
and transfer files by phone to bulletin board computers. You don't have
to know about these programs to use DoList. If you don't own a modem,
you are missing out on a whole level of computer enjoyment and you should
go to your nearest computer store and buy one.

Try these examples:

PIPEDIR \*.BAK /S|DOLIST DEL @L     ;deletes all BAK files in all directories.
DIR|FIND " BAK "|DOLIST DEL @1.@2   ;deletes BAK files in current directory.

Create a file called TRASH.LST that contains extensions that need to
be deleted from your hard disk.
Example:
BAK
BWS
TMP
IFF
BDC
BTX
BP?

Then you can get rid of these files by typing:

DOLIST WHEREIS *.@L|DOLIST DEL @L <TRASH.LST or
TYPE TRASH.LST|DOLIST WHEREIS *.@L|DOLIST DEL @L


Did you ever accidently copy a floppy disk onto your hard disk and get
the files in your root directory instead of the directory that they were
supposed to go into? When that happens you've got to go in and figure out
what files to delete. PIPEDIR and DOLIST can fix your problem.

PIPEDIR A:*.*/F|DOLIST DEL @L

The list of files on A: is used for the list to delete the files on C:.


Suppose you want to ARC all files that have been changed since the last
backup. You could type:

PIPEDIR \ /S/A|DOLIST PKARC A BACKFILE.ARC @L

This will cause all modified files to be ARC'ed into BACKFILE.ARC.


Suppose you want to test the integrity of all your ARC files. You
could type:

WHEREIS *.ARC|DOLIST PKXARC -T @L >ERROR.LOG

This will run a test on all ARC files on the disk with output to
a file called ERROR.LOG. This file can then be printed.


Now suppose after you have tested the integrity of your arc files, you
want to make a list of all files in the ARC and sort them, you type:

TYPE ERROR.LOG|FIND "Testing"|DOLIST @2@T|SORT >SORTLIST or from the beginning

WHEREIS *.ARC|DOLIST PKXARC -T @L|FIND "Testing"|DOLIST @2@T|SORT >SORTLIST
which makes for quite a pipe.


Suppose you have a lot of ARC files on your hard disk and you want
to Re-Arc them with PKARC. Here's what you do:

Create a \TEMP directory in the root. (MD \TEMP)
Create a BAT file called UPDATE.BAT containing the following commands:

pkxarc %1 \temp
del %1
pkarc a %1 \temp\*.*
echo Y|del \temp\*.*

Test this bat file by typing UPDATE <file.arc> to make sure it works.
Then, to do the whole disk, type:

PIPEDIR \*.ARC /S|DOLIST UPDATE @L


Have you ever copied a floppy onto your hard disk and have it end up
in your root directory? DoList allows you to reverse this mistake. Put
the floppy back in drive A: and type:

PIPEDIR A:*.*/N|DOLIST DEL C:\@L

This will read the list of files on A: and use it as a delete list to
remove the files from C:\.


               *-=-=-=-=-=<< oOo >>=-=-=-=-=-*

Other Computer Tyme Software:
======================================================

The Computer Tyme Dos ToolBox... Makes DOS easier for the novice,
more powerful for the professional.

DIRECTORY MASTER is a powerful hard disk managment utility. It
brings up your hard disk files and allows you to mark selected
files so you can copy them, delete them, or move them. It also
allows you to rename files, change dates, and change attributes.
You can also run programs or set up your function keys to run
programs on selected files.

DOLIST makes being at DOS easier. It gives you full line editing,
like a word processor, for your commands. It also stores commands
so that you can re-execute them. It remembers subdirectories and
allows you to go back to them by pressing the TAB key. It offers
programmable function keys, DOS extensions, multiple execution,
and many more features you have got to have.

PICK DIRECTORY allows you to move through the directory system by
displaying a graphic tree and letting you use your arrow keys to
move around. It also lets you create, delete, rename, and hide
directories.

TEDIT (from SemWare) is a powerful, easy to use full screen
editor.

MARXTSR is a set of memory and TSR management utilities that let
you load and unload TSRs (Terminate and stay resident programs)
from memory. Utilities to list menory allocation and turn TSR's
on and off.

And many more ... Also includes is D, a fancy directory listing
program; WHEREIS, for finding stuff on you hard disk, SORT, MOVE,
FIND, FREE, PIPEDIR, VERSION, and many more.

The Dos Toolbox sells for $59.95.

======================================================

We are also selling QEdit from Semware. QEdit is a professional
editor from Semware. TEdit is a mini version of QEdit. If you
like TEdit, You'll love QEdit.

1-800-548-5353 Order Line
1-417-866-1222 Voice Line
1-417-866-1665 BBS Data line * 1200/2400 * 8N1 * ANSI or VT100


MARXMENU:

For the menu user who is interested in POWER!

MarxMenu version is a menu system that uses NO RAM. MarxMenu is
compatible with all networks and contains a powerful menu language.
This language gives you complete screen control as well as
conditional menus. Math and string functions as well as
multidimensional arrays are supported. MarxMenu can read environment
variables, ports, ram locations, time, dates, the contents of text
files, ect. and make decisions on them.

Screen control includes multi-layer exploding windows with
unlimited number of selections and unlimited windows. 43/50 line
ega and vga modes are supported. MarxMenu contains a screen
blanker, password security on anything, keyboard lockout.
MarxMenu can run programs while staying resident and read the dos
errorlevel codes they return or marxmenu can return custom
errorlevel codes to a calling program or batch file. MarxMenu can
view text files in a window, read text files into an array and
let you choose a line from that array in a window. MarxMenu can
write string arrays to text files.

This menu system is targeted at the user whose primary interest
is POWER! Here is a simple sample of what MarxMenu script looks
like:

==========================================

;This menu is a sample of a simple menu.
;To run this menu type 'MARX SAMPLE'

TextColor Yellow Red
ClearScreen
BoxBorderColor Green Blue
BoxInsideColor Yellow Blue
DrawBox 25 7 32 13
WriteCenter '* Sample Menu *'
Writeln
Writeln
Writeln '   A - Directory'
Writeln '   B - Wide Directory'
Writeln '   C - Run ChkDsk'
Writeln '   D - Type Menu to Screen'
Writeln '   E - Edit This Menu'
Writeln '   F - Drop to Dos'
Writeln ' Esc - Exit'
Writeln
Write ' Select: '

OnKey 'A'
   DIR
   Pause   ;Lets you see the directory before screen clears

Onkey 'B'
   DIR/W
   Pause

OnKey 'C'
   CHKDSK
   Pause

OnKey 'D'
   TYPE SAMPLE.MNU|MORE
   Pause

OnKey 'E'
   TEDIT SAMPLE.MNU

OnKey 'F'
   @Echo To Return to the SAMPLE menu type EXIT
   @Echo .
   COMMAND


MarxMenu comes with MarxEdit and MARXTSR manager and a few goodies out of
the DOS ToolBox. The Network Survival Kit is a network version of almost
every utility I've ever written. It's sold on a per fileserver basis.

              _______
         ____|__     |               (tm)
      --|       |    |-------------------
        |   ____|__  |  Association of
        |  |       |_|  Shareware
        |__|   o   |    Professionals
      -----|   |   |---------------------
           |___|___|    APPROVED VENDOR

   ==========================================


     Make Check            Computer Tyme            Order Form LO
     Payable To:    411 North Sherman Suite 300
                       Springfield Mo. 65802
                  [phone]  [phone]

     Please send me Computer Tyme Software.

     =============================================================

     Name:        ________________________________________________

     Address:     ________________________________________________

     City/St/Zip: ________________________________________________

     Phone:       ________________________________________________

     Computer:    ________________________________________________

     Got From:    ________________________________________________

     Comments:    ________________________________________________

                  ________________________________________________


     Single User Version:

     ___ Enclosed is $59.95 for MarxMenu.

     ___ Enclosed is $59.95 for the DOS ToolBox.

     ___ Enclosed is $99.95 for MarxMenu, the Dos ToolBox and DM3.

     Network Version (1 per file server):

     ___ Enclosed is $495 for Network Survival Kit.

     ___ Add $3.00 for Shipping and Handling.

     ___ I need 3 1/2 Inch Media.

     =============================================================